package com.tsy.server.manage.service;

import com.tsy.server.manage.model.dto.DeviceFirmwareDTO;
import com.tsy.server.manage.model.dto.DeviceFirmwareNoteDTO;
import com.tsy.server.manage.model.dto.DeviceFirmwareUpgradeDTO;
import com.tsy.server.manage.model.param.DeviceFirmwareQueryParam;
import com.tsy.server.manage.model.param.DeviceFirmwareUploadParam;
import com.dji.sdk.cloudapi.firmware.OtaCreateDevice;
import com.dji.sdk.common.PaginationData;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;
import java.util.Optional;

/**
 * @author sean
 * @version 1.2
 * @date 2022/8/16
 */
public interface IDeviceFirmwareService {

    /**
     * 根据设备机型与固件版本查询具体固件信息。
     *
     * @param workspaceId 工作空间ID
     * @param deviceName 设备型号
     * @param version 固件版本
     * @return
     */
    Optional<DeviceFirmwareDTO> getFirmware(String workspaceId, String deviceName, String version);

    /**
     * 获取该设备机型的最新固件发布说明。
     * @param deviceName 设备型号
     * @return
     */
    Optional<DeviceFirmwareNoteDTO> getLatestFirmwareReleaseNote(String deviceName);

    /**
     * 获取设备需要升级的固件信息。
     *
     * @param workspaceId 工作空间ID
     * @param upgradeDTOS 升级参数
     * @return
     */
    List<OtaCreateDevice> getDeviceOtaFirmware(String workspaceId, List<DeviceFirmwareUpgradeDTO> upgradeDTOS);

    /**
     * 分页查询固件版本信息。
     *
     * @param workspaceId 工作空间ID
     * @param param 查询参数
     * @return
     */
    PaginationData<DeviceFirmwareDTO> getAllFirmwarePagination(String workspaceId, DeviceFirmwareQueryParam param);

    /**
     * 根据 MD5 检查文件是否存在。
     *
     * @param workspaceId 工作空间ID
     * @param fileMd5 文件MD5
     * @return
     */
    Boolean checkFileExist(String workspaceId, String fileMd5);

    /**
     * 导入固件文件用于设备升级。
     * @param workspaceId 工作空间ID
     * @param creator 创建人
     * @param param 上传参数
     * @param file 固件文件
     */
    void importFirmwareFile(String workspaceId, String creator, DeviceFirmwareUploadParam param, MultipartFile file);

    /**
     * 保存固件的文件信息。
     * @param firmware 固件信息
     * @param deviceNames 适配机型
     */
    void saveFirmwareInfo(DeviceFirmwareDTO firmware, List<String> deviceNames);

    /**
     * 更新固件的文件信息。
     * @param firmware 固件信息
     */
    void updateFirmwareInfo(DeviceFirmwareDTO firmware);
}
